home *** CD-ROM | disk | FTP | other *** search
/ PC World Komputer 2010 April / PCWorld0410.iso / hity wydania / Ubuntu 9.10 PL / karmelkowy-koliberek-desktop-9.10-i386-PL.iso / casper / filesystem.squashfs / usr / share / doc / libpisock9 / README.debugging < prev    next >
Text File  |  2007-02-16  |  4KB  |  114 lines

  1. $Id: README.debugging,v 1.7 2007/02/16 18:26:41 desrod Exp $
  2. ======================================================================
  3. README.debugging
  4. Author: JP Rosevear, David A. Desrosiers
  5. Updated: Mon Oct 16 16:37:45 EDT 2006
  6. ======================================================================
  7. This README will describe in detail, the process and programs necessary
  8. to debug any problems you might have with pilot-link with libusb on
  9. Linux and Mac OS X machines.
  10.  
  11. Debugging pilot-link
  12. --------------------------------------------------------------------------
  13. To begin debugging problems, the core library "libpisock" contains
  14. runtime debugging features. You do not need to recompile pilot-link to
  15. include these.
  16.  
  17. If you want to disable them (not recommended, but you may if you know
  18. what you're doing), simply pass the --disable-debug configure option to
  19. disable at build time. Debugging is enabled by default, so there is no
  20. --enable-debugging target.
  21.  
  22.  
  23. Environment variables for debugging
  24. --------------------------------------------------------------------------
  25.     The runtime debugging is controlled by setting four different
  26.     environment variables. These are:
  27.  
  28.         PILOT_DEBUG
  29.         PILOT_DEBUG_LEVEL
  30.         PILOT_LOG
  31.         PILOT_LOGFILE
  32.  
  33.     PILOT_DEBUG controls what type of information is output to STDOUT or
  34.     your logfile. The levels of information available are:
  35.         
  36.         DEV      Device IO
  37.         SLP      Serial Link Protocol
  38.         PADP     Packet Assembly/Disassembly Protocol
  39.         CMP      Connection Management Protocol
  40.         NET      Network Sync Protocol
  41.         SOCK     Socket Commands
  42.         API      API (datebook, address, todo, memos, etc)
  43.         USER     User data
  44.  
  45.     You can specify multiple types of information to be output/captured
  46.     as follows:
  47.  
  48.         setenv PILOT_DEBUG "DEV SLP PADP" # for csh
  49.  
  50.     or
  51.  
  52.         export PILOT_DEBUG="DEV SLP PADP" # for bash
  53.  
  54.     PILOT_DEBUG_LEVEL controls the level of information displayed for
  55.     each type. The availab levels are:
  56.  
  57.         NONE     No information displayed at all
  58.         ERR      Critical errors
  59.         WARN     Non-critical errors
  60.         INFO     General information
  61.         DEBUG    Verbose debugging info, everything!
  62.  
  63.     If the variable PILOT_LOG is set (nonzero), the information will be
  64.     written to the file "pilot-link.debug" by default. This logfile name
  65.     be overridden by setting PILOT_LOGFILE to the desired file name you
  66.     wish to use.
  67.  
  68.     If you wish to disable logging for a particular session, just set
  69.     PILOT_LOG to 0.
  70.  
  71.     Here's an example of the overall usage (for bash, your shell may
  72.     vary):
  73.  
  74.         export PILOT_DEBUG="DEV SLP CMP PADP SOCK NET USER"
  75.         export PILOT_DEBUG_LEVEL="DEBUG"
  76.         export PILOT_LOG=1
  77.         export PILOT_LOGFILE="debug.log"
  78.  
  79.     These logs will provide a level of detail necessay for the
  80.     pilot-link developers (or yourself) to try to track down why your
  81.     Palm device is not communicating properly with pilot-link on your
  82.     machine or operating system.
  83.  
  84.  
  85. Capturing the output 
  86. --------------------------------------------------------------------------
  87.     FIXME
  88.  
  89.  
  90. How do I read this stuff?
  91. --------------------------------------------------------------------------
  92.     FIXME
  93.  
  94.  
  95. Now what do I do next?
  96. --------------------------------------------------------------------------
  97.     FIXME
  98.  
  99.  
  100. Donating to pilot-link
  101. --------------------------------------------------------------------------
  102.         Do you like our work? Do you rely on the code we release for
  103.         your daily work or for your own commercial or OSS project?
  104.  
  105.         Please consider donating to keep the project going. We're 100%
  106.         self-funded, and we see a LOT of traffic from users and
  107.         downloads. Every contribution helps, whether to pay for
  108.         bandwidth or to buy devices for testing.
  109.  
  110.         You can help support us by visiting the pilot-link.org site and
  111.         clicking on the "Donate" button on the left side of the page.
  112.  
  113.         We thank you for your contributions, whatever you can offer.
  114.